.\"  -*- nroff -*-
.\"
.Dd November 1, 2011
.Dt SHP 1
.Os
.Sh NAME
.Nm shp
.Nd Like PHP except you write your script in shell script
.Sh SYNOPSIS
.Nm shp
.Op Ar options
.Op Ar script Op args ...
.Sh DESCRIPTION
.Nm
parses and executes SHP scripts in the manner of PHP, except nested scripts
are written in shell scripting language instead of the PHP language.
.Nm
outputs its script file, with nested
.Pa <?shp ... ?>
blocks executed as shell scripts.
.Pp
If no
.Ar script
is provided, standard input is read.
Otherwise, any subsequent arguments are passed to the script.
.Pp
To pass arguments to a standard input script, use `-' for
.Ar script .
.Pp
If the first line of the input script starts with a shebang (`#!'), it is ignored.
This allows scripts to be made executable by putting
.Pa #!@bindir@/shp
as the first line.
.Sh OPTIONS
.Bl -tag -width XXX
.It Fl \-check
Just check the syntax of the script instead of executing it.
.It Fl \-dump
Just output the generated shell script instead of executing it.
.It Fl \-shell
Specify an alternate shell (the default is `@BASH@ -s').
.It Fl \-help
Display command line help.
.It Fl \-version
Display version and exit.
.El
.Sh VERSION
This man page documents
.Nm
version @PACKAGE_VERSION@.
.Sh AUTHOR
.An Archie L. Cobbs Aq archie@dellroad.org
